home *** CD-ROM | disk | FTP | other *** search
/ MacHack 2000 / MacHack 2000.toast / pc / The Hacks / MacHacksBug / Python 1.5.2c1 / Tools / world / README next >
Encoding:
Text File  |  2000-06-23  |  2.8 KB  |  86 lines
  1. world -- Print mappings between country names and DNS country codes.
  2.  
  3. Contact: Barry Warsaw
  4. Email:   bwarsaw@python.org
  5.  
  6. This script will take a list of Internet addresses and print out where in the
  7. world those addresses originate from, based on the top-level domain country
  8. code found in the address.  Addresses can be in any of the following forms:
  9.  
  10.     xx                -- just the country code or top-level domain identifier
  11.     host.domain.xx    -- any Internet host or network name
  12.     somebody@where.xx -- an Internet email address
  13.  
  14. If no match is found, the address is interpreted as a regular expression [*]
  15. and a reverse lookup is attempted.  This script will search the country names
  16. and print a list of matching entries.  You can force reverse mappings with the
  17. `-r' flag (see below).
  18.  
  19. For example:
  20.  
  21.     %% world tz us
  22.     tz originated from Tanzania, United Republic of
  23.     us originated from United States
  24.  
  25.     %% world united
  26.     united matches 6 countries:
  27.         ae: United Arab Emirates
  28.         uk: United Kingdom (common practice)
  29.         um: United States Minor Outlying Islands
  30.         us: United States
  31.         tz: Tanzania, United Republic of
  32.         gb: United Kingdom
  33.  
  34.  
  35.  [*] Note that regular expressions must conform to Python 1.5's re.py module
  36.  syntax.  The comparison is done with the search() method.
  37.  
  38. Country codes are maintained by the RIPE Network Coordination Centre,
  39. in coordination with the ISO 3166 Maintenance Agency at DIN Berlin.  The
  40. authoritative source of counry code mappings is:
  41.  
  42.     <url:ftp://info.ripe.net/iso3166-countrycodes>
  43.  
  44. The latest known change to this information was:
  45.  
  46.     Thu Aug  7 17:59:51 MET DST 1997
  47.  
  48. This script also knows about non-geographic top-level domains.
  49.  
  50. Usage: world [-d] [-p file] [-o] [-h] addr [addr ...]
  51.  
  52.     --dump
  53.     -d
  54.         Print mapping of all top-level domains.
  55.  
  56.     --parse file
  57.     -p file
  58.         Parse an iso3166-countrycodes file extracting the two letter country
  59.         code followed by the country name.  Note that the three letter country
  60.         codes and numbers, which are also provided in the standard format
  61.         file, are ignored.
  62.  
  63.     --outputdict
  64.     -o
  65.         When used in conjunction with the `-p' option, output is in the form
  66.         of a Python dictionary, and country names are normalized
  67.         w.r.t. capitalization.  This makes it appropriate for cutting and
  68.         pasting back into this file.
  69.  
  70.     --reverse
  71.     -r
  72.         Force reverse lookup.  In this mode the address can be any Python
  73.         regular expression; this is matched against all country names and a
  74.         list of matching mappings is printed.  In normal mode (e.g. without
  75.         this flag), reverse lookup is performed on addresses if no matching
  76.         country code is found.
  77.  
  78.     -h
  79.     --help
  80.         Print this message.
  81.  
  82.  
  83. Local Variables:
  84. indent-tabs-mode: nil
  85. End:
  86.